home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / Talking Clock Pro™ 2.0.1 / Talking Clock Pro Source / Controller / API Readme.c next >
Encoding:
C/C++ Source or Header  |  1993-08-28  |  2.8 KB  |  54 lines  |  [TEXT/CWIE]
  1. #if 0
  2.  
  3.     To compile this clock, you need Think C 6.0 and a special version of MacHeaders
  4.     where many files that are #if 0 in the original Mac #includes.c are set to #if 1
  5.     If you do not know how to generate a new copy of MacHeaders, please consult your
  6.     Think C manual. If you still do not know how to do this; I suggest that you have
  7.     not reached the technical skill level needed to fully assimilate this code.
  8.  
  9.     Stockholm 93-08-27
  10.  
  11.     This simple clock can also serve as a starting place for your own applications.
  12.     What do you need to do?
  13.  
  14.     1)    You will have to change the source as it is.
  15.  
  16.     2)    For each window you create, you will have to provide a callback-function record.
  17.  
  18.     3)    You will also have to provide application callbacks for all events (these cannot
  19.         be NULL; the window callbacks can be NULL) The app callbacks are called when a
  20.         window is not frontmost to handle an event.
  21.  
  22.     4)    Go from there. Use the message system already built-in, and store your data in
  23.         the data part of the DefWindowRec. In your window's Prepare and DoCommand functions,
  24.         call the application's callbacks as well.
  25.  
  26.     There are some restrictions on applications that you write using this code as a
  27.     starting place:
  28.  
  29.     i)        You cannot blame me for any crashes or lost data even if they are due to bugs
  30.         in my code and not yours. You use the code at your own risk.
  31.     ii)        I would very much appreciate to get a copy of what you're writing, when you're
  32.         done. Failing that, a postcard would be swell.
  33.     iii)    Please send any bug fixes you make to the code to me, so I may incorporate
  34.         them in the base code and others may benefit. If you do, I will keep you on a list
  35.         of people to notify of other bug fixes made.
  36.     iv)        Once again; I cannot take responsibility for your use of this code, but please
  37.         re-distribute my code only in its unmodified state. If you distribute a program
  38.         built using a modified version of this code, or distribute a modified copy of this
  39.         code, include a statement saying you have responsibility for the results, but also
  40.         include a line saying "Some parts ©1993 Jon Wätte"
  41.     v)        The comment in the file x.h about limitation of my liability and responsibility
  42.         goes for all of this code: IF THE LAW WHERE YOU LIVE, WORK, OR DISTRIBUTE YOUR
  43.         WORK DOES NOT ALLOW ME TO DISCLAIM ANY AND ALL RESPONSIBILITY FOR ANY DAMAGES CAUSED
  44.         BY THIS CODE OR THE DERIVATES THEREOF, YOU MAY NOT USE THIS CODE, ON THE PENALTY OF
  45.         USD $1,000,000,000 (one billion) OR SEK 10,000,000,000 Kr WHICHEVER IS GREATER.
  46.     vi)        I may provide some limited feedback if you mail me with questions about this
  47.         code; I may even help you with specific problems you may have. However, I am a very
  48.         busy person; perhaps more so than I would wish to be, so please understand if I do
  49.         not have the time or energy needed to fully support this code base.
  50.  
  51.     Good luck!
  52.  
  53. #endif
  54.